-- Network Working Group L. Heintz
-- Request For Comments: 2742 Cisco Systems
-- Category: Standards Track S. Gudur
-- Independent Consultant
-- M. Ellison, Ed.
-- Ellison Software Consulting, Inc.
-- January 2000-- Definitions of Managed Objects for Extensible SNMP AgentsAGENTX-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,Unsigned32, mib-2
FROM SNMPv2-SMI
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB
MODULE-COMPLIANCE,OBJECT-GROUPFROM SNMPv2-CONF
TEXTUAL-CONVENTION,TimeStamp,TruthValue,TDomainFROM SNMPv2-TC;agentxMIB MODULE-IDENTITYLAST-UPDATED"200001100000Z"-- Midnight 10 January 2000ORGANIZATION"AgentX Working Group"CONTACT-INFO"WG-email: agentx@dorothy.bmc.com
Subscribe: agentx-request@dorothy.bmc.com
WG-email Archive: ftp://ftp.peer.com/pub/agentx/archives
FTP repository: ftp://ftp.peer.com/pub/agentx
http://www.ietf.org/html.charters/agentx-charter.html
Chair: Bob Natale
ACE*COMM Corporation
Email: bnatale@acecomm.com
WG editor: Mark Ellison
Ellison Software Consulting, Inc.
Email: ellison@world.std.com
Co-author: Lauren Heintz
Cisco Systems,
EMail: lheintz@cisco.com
Co-author: Smitha Gudur
Independent Consultant
Email: sgudur@hotmail.com
"DESCRIPTION"This is the MIB module for the SNMP Agent Extensibility
Protocol (AgentX). This MIB module will be implemented by
the master agent.
"REVISION"200001100000Z"-- Midnight 10 January 2000DESCRIPTION"Initial version published as RFC 2742."::={ mib-2 74}-- Textual ConventionsAgentxTAddress::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"Denotes a transport service address. This is identical to
the TAddress textual convention (SNMPv2-SMI) except that
zero-length values are permitted.
"SYNTAXOCTETSTRING(SIZE(0..255))-- Administrative assignmentsagentxObjects OBJECTIDENTIFIER::={ agentxMIB 1}agentxGeneral OBJECTIDENTIFIER::={ agentxObjects 1}agentxConnection OBJECTIDENTIFIER::={ agentxObjects 2}agentxSession OBJECTIDENTIFIER::={ agentxObjects 3}agentxRegistration OBJECTIDENTIFIER::={ agentxObjects 4}agentxDefaultTimeout OBJECT-TYPESYNTAXINTEGER(0..255)UNITS"seconds"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The default length of time, in seconds, that the master
agent should allow to elapse after dispatching a message
to a session before it regards the subagent as not
responding. This is a system-wide value that may
override the timeout value associated with a particular
session (agentxSessionTimeout) or a particular registered
MIB region (agentxRegTimeout). If the associated value of
agentxSessionTimeout and agentxRegTimeout are zero, or
impractical in accordance with implementation-specific
procedure of the master agent, the value represented by
this object will be the effective timeout value for the
master agent to await a response to a dispatch from a
given subagent.
"DEFVAL{5}::={ agentxGeneral 1}agentxMasterAgentXVer OBJECT-TYPESYNTAXINTEGER(1..255)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The AgentX protocol version supported by this master agent.
The current protocol version is 1. Note that the master agent
must also allow interaction with earlier version subagents.
"::={ agentxGeneral 2}-- The AgentX Subagent Connection GroupagentxConnTableLastChange OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when the last row creation or deletion
occurred in the agentxConnectionTable.
"::={ agentxConnection 1}agentxConnectionTable OBJECT-TYPESYNTAXSEQUENCEOF AgentxConnectionEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The agentxConnectionTable tracks all current AgentX transport
connections. There may be zero, one, or more AgentX sessions
carried on a given AgentX connection.
"::={ agentxConnection 2}agentxConnectionEntry OBJECT-TYPESYNTAX AgentxConnectionEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An agentxConnectionEntry contains information describing a
single AgentX transport connection. A connection may be
used to support zero or more AgentX sessions. An entry is
created when a new transport connection is established,
and is destroyed when the transport connection is terminated.
"INDEX{ agentxConnIndex }::={ agentxConnectionTable 1}
AgentxConnectionEntry ::=SEQUENCE{
agentxConnIndex Unsigned32,
agentxConnOpenTime TimeStamp,
agentxConnTransportDomain TDomain,
agentxConnTransportAddress AgentxTAddress}agentxConnIndex OBJECT-TYPESYNTAXUnsigned32(1..4294967295)MAX-ACCESSnot-accessible
STATUScurrentDESCRIPTION"agentxConnIndex contains the value that uniquely identifies
an open transport connection used by this master agent
to provide AgentX service. Values of this index should
not be re-used. The value assigned to a given transport
connection is constant for the lifetime of that connection.
"::={ agentxConnectionEntry 1}agentxConnOpenTime OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when this connection was established
and, therefore, its value when this entry was added to the table.
"::={ agentxConnectionEntry 2}agentxConnTransportDomain OBJECT-TYPESYNTAXTDomainMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The transport protocol in use for this connection to the
subagent.
"::={ agentxConnectionEntry 3}agentxConnTransportAddress OBJECT-TYPESYNTAXAgentxTAddressMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The transport address of the remote (subagent) end of this
connection to the master agent. This object may be zero-length
for unix-domain sockets (and possibly other types of transport
addresses) since the subagent need not bind a filename to its
local socket.
"::={ agentxConnectionEntry 4}-- The AgentX Subagent Session GroupagentxSessionTableLastChange OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when the last row creation or deletion
occurred in the agentxSessionTable.
"::={ agentxSession 1}agentxSessionTable OBJECT-TYPESYNTAXSEQUENCEOF AgentxSessionEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table of AgentX subagent sessions currently in effect.
"::={ agentxSession 2}agentxSessionEntry OBJECT-TYPESYNTAX AgentxSessionEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Information about a single open session between the AgentX
master agent and a subagent is contained in this entry. An
entry is created when a new session is successfully established
and is destroyed either when the subagent transport connection
has terminated or when the subagent session is closed.
"INDEX{ agentxConnIndex, agentxSessionIndex }::={ agentxSessionTable 1}
AgentxSessionEntry ::=SEQUENCE{
agentxSessionIndex Unsigned32,
agentxSessionObjectID OBJECTIDENTIFIER,
agentxSessionDescr SnmpAdminString,
agentxSessionAdminStatus INTEGER,
agentxSessionOpenTime TimeStamp,
agentxSessionAgentXVer INTEGER,
agentxSessionTimeout INTEGER}agentxSessionIndex OBJECT-TYPESYNTAXUnsigned32(0..4294967295)MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A unique index for the subagent session. It is the same as
h.sessionID defined in the agentx header. Note that if
a subagent's session with the master agent is closed for
any reason its index should not be re-used.
A value of zero(0) is specifically allowed in order
to be compatible with the definition of h.sessionId.
"::={ agentxSessionEntry 1}agentxSessionObjectID OBJECT-TYPESYNTAXOBJECTIDENTIFIERMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This is taken from the o.id field of the agentx-Open-PDU.
This attribute will report a value of '0.0' for subagents
not supporting the notion of an AgentX session object
identifier.
"::={ agentxSessionEntry 2}agentxSessionDescr OBJECT-TYPESYNTAXSnmpAdminStringMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"A textual description of the session. This is analogous to
sysDescr defined in the SNMPv2-MIB in RFC 1907 [19] and is
taken from the o.descr field of the agentx-Open-PDU.
This attribute will report a zero-length string value for
subagents not supporting the notion of a session description.
"::={ agentxSessionEntry 3}agentxSessionAdminStatus OBJECT-TYPESYNTAXINTEGER{up(1),down(2)}MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The administrative (desired) status of the session. Setting
the value to 'down(2)' closes the subagent session (with c.reason
set to 'reasonByManager').
"::={ agentxSessionEntry 4}agentxSessionOpenTime OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when this session was opened and,
therefore, its value when this entry was added to the table.
"::={ agentxSessionEntry 5}agentxSessionAgentXVer OBJECT-TYPESYNTAXINTEGER(1..255)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The version of the AgentX protocol supported by the
session. This must be less than or equal to the value of
agentxMasterAgentXVer.
"::={ agentxSessionEntry 6}agentxSessionTimeout OBJECT-TYPESYNTAXINTEGER(0..255)UNITS"seconds"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The length of time, in seconds, that a master agent should
allow to elapse after dispatching a message to this session
before it regards the subagent as not responding. This value
is taken from the o.timeout field of the agentx-Open-PDU.
This is a session-specific value that may be overridden by
values associated with the specific registered MIB regions
(see agentxRegTimeout). A value of zero(0) indicates that
the master agent's default timeout value should be used
(see agentxDefaultTimeout).
"::={ agentxSessionEntry 7}-- The AgentX Registration GroupagentxRegistrationTableLastChange OBJECT-TYPE
SYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when the last row creation or deletion
occurred in the agentxRegistrationTable.
"::={ agentxRegistration 1}agentxRegistrationTable OBJECT-TYPESYNTAXSEQUENCEOF AgentxRegistrationEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table of registered regions.
"::={ agentxRegistration 2}agentxRegistrationEntry OBJECT-TYPESYNTAX AgentxRegistrationEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Contains information for a single registered region. An
entry is created when a session successfully registers a
region and is destroyed for any of three reasons: this region
is unregistered by the session, the session is closed,
or the subagent connection is closed.
"INDEX{ agentxConnIndex, agentxSessionIndex, agentxRegIndex }::={ agentxRegistrationTable 1}
AgentxRegistrationEntry ::=SEQUENCE{
agentxRegIndex Unsigned32,
agentxRegContext OCTETSTRING,
agentxRegStart OBJECTIDENTIFIER,
agentxRegRangeSubId Unsigned32,
agentxRegUpperBound Unsigned32,
agentxRegPriority Unsigned32,
agentxRegTimeout INTEGER,
agentxRegInstance TruthValue}agentxRegIndex OBJECT-TYPESYNTAXUnsigned32(1..4294967295)MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"agentxRegIndex uniquely identifies a registration entry.
This value is constant for the lifetime of an entry.
"::={ agentxRegistrationEntry 1}agentxRegContext OBJECT-TYPESYNTAXOCTETSTRINGMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The context in which the session supports the objects in this
region. A zero-length context indicates the default context.
"::={ agentxRegistrationEntry 2}agentxRegStart OBJECT-TYPESYNTAXOBJECTIDENTIFIERMAX-ACCESSread-onlySTATUScurrentDESCRIPTION
"The starting OBJECT IDENTIFIER of this registration entry. The
session identified by agentxSessionIndex implements objects
starting at this value (inclusive). Note that this value could
identify an object type, an object instance, or a partial object
instance.
"::={ agentxRegistrationEntry 3}agentxRegRangeSubId OBJECT-TYPESYNTAXUnsigned32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"agentxRegRangeSubId is used to specify the range. This is
taken from r.region_subid in the registration PDU. If the value
of this object is zero, no range is specified. If it is non-zero,
it identifies the `nth' sub-identifier in r.region for which
this entry's agentxRegUpperBound value is substituted in the
OID for purposes of defining the region's upper bound.
"::={ agentxRegistrationEntry 4}agentxRegUpperBound OBJECT-TYPESYNTAXUnsigned32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"agentxRegUpperBound represents the upper-bound sub-identifier in
a registration. This is taken from the r.upper_bound in the
registration PDU. If agentxRegRangeSubid (r.region_subid) is
zero, this value is also zero and is not used to define an upper
bound for this registration.
"::={ agentxRegistrationEntry 5}agentxRegPriority OBJECT-TYPESYNTAXUnsigned32MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The registration priority. Lower values have higher priority.
This value is taken from r.priority in the register PDU.
Sessions should use the value of 127 for r.priority if a
default value is desired.
"::={ agentxRegistrationEntry 6}agentxRegTimeout OBJECT-TYPESYNTAXINTEGER(0..255)UNITS"seconds"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The timeout value, in seconds, for responses to
requests associated with this registered MIB region.
A value of zero(0) indicates the default value (indicated
by by agentxSessionTimeout or agentxDefaultTimeout) is to
be used. This value is taken from the r.timeout field of
the agentx-Register-PDU.
"::={ agentxRegistrationEntry 7}agentxRegInstance OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of agentxRegInstance is `true' for
registrations for which the INSTANCE_REGISTRATION
was set, and is `false' for all other registrations.
"::={ agentxRegistrationEntry 8}-- Conformance Statements for AgentXagentxConformance OBJECTIDENTIFIER::={ agentxMIB 2}
agentxMIBGroups OBJECTIDENTIFIER::={ agentxConformance 1}agentxMIBCompliances OBJECTIDENTIFIER::={ agentxConformance 2}-- Compliance Statements for AgentXagentxMIBCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for SNMP entities that implement the
AgentX protocol. Note that a compliant agent can implement all
objects in this MIB module as read-only.
"MODULE-- this moduleMANDATORY-GROUPS{ agentxMIBGroup }OBJECT agentxSessionAdminStatus
MIN-ACCESSread-onlyDESCRIPTION"Write access is not required.
"::={ agentxMIBCompliances 1}agentxMIBGroup OBJECT-GROUPOBJECTS{
agentxDefaultTimeout,
agentxMasterAgentXVer,
agentxConnTableLastChange,
agentxConnOpenTime,
agentxConnTransportDomain,
agentxConnTransportAddress,
agentxSessionTableLastChange,
agentxSessionTimeout,
agentxSessionObjectID,
agentxSessionDescr,
agentxSessionAdminStatus,
agentxSessionOpenTime,
agentxSessionAgentXVer,
agentxRegistrationTableLastChange,
agentxRegContext,
agentxRegStart,
agentxRegRangeSubId,
agentxRegUpperBound,
agentxRegPriority,
agentxRegTimeout,
agentxRegInstance
}STATUScurrentDESCRIPTION"All accessible objects in the AgentX MIB.
"::={ agentxMIBGroups 1}END